home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Visual Basic Toolbox
/
Visual Basic Toolbox (P.I.E.)(1996).ISO
/
setup_ut
/
iware420
/
appsetup.inf
< prev
next >
Wrap
INI File
|
1995-09-14
|
27KB
|
598 lines
; -------------------------------------------------------------
;
; Sample Installation Script -- 073195 -- Version 4.20
;
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; About This File
; ===============
;
; This file, APPSETUP.INF, contains information that InstallWare uses to
; install applications. This file must be in the same directory as the
; program files IW.EXE(if used) and INSTALL.EXE. The two files can be on
; a floppy disk, a hard disk, or a network disk drive.
;
; The information in this file determines
;
; * The names of the disks and directories from which, and to which,
; InstallWare copies files.
;
; * The name of the group that InstallWare creates in Program Manager's
; window, and the names of program items that InstallWare adds to that
; group.
;
; You can create your own InstallWare program by changing some of the
; information in this file.
;
; The Parts of APPSETUP.INF
; -------------------------
;
; APPSETUP.INF is similar in format to a Windows initialization (.INI) file.
;
; Sections: APPSETUP.INF is divided into sections. Each section is identified
; by a name enclosed in square brackets.
;
; Most section names are "hard-coded". However, some section names
; are defined within other sections, and are therefore easily
; customizable.
;
; Comments: A comment begins with a semicolon. You can include a comment
; on the same line as syntax, as long as it comes after the syntax.
;
; Spaces: Spaces are ignored, except when between double quotes.
; Blank lines are also ignored.
;
; Sections in This File
; ---------------------
;
; The rest of this file contains the actual sections and statements
; that make up the working file. It also includes comments that
; explain each section and statement.
;
; Macros
; ------
;
; Any String that you define in this file can include one of the following
; macros to enable defining directory locations that would be impossible
; otherwise. Simply place the desired macro in the string where you would
; normally use a pathspec.
;
; Supported Macros in this Version
; #W The user's WINDOWS directory
; #S The user's SYSTEM directory
; #D The directory in which the installation actually occurred
; #V The DRIVE on which the installation occurred, such as C: (no backslash)
;
; If you need to specify any of these letter combinations and do not want
; the macro expansion to take place, just precede the combination with an
; extra #, as in the following: "The ##Workplace ##Solution"
;
;
;
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; INFOFILE
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; The [infofile] section describes various miscellaneous aspects
; of the installation. The FILENAME label indicates the name of
; the text file that is shown to the user when the program starts
; up. The APPNAME label is used to refer to the name of the
; application being installed.
;
; The EXEFILE label is used to tell InstallWare that you would
; like to run a file after the installation is complete. This
; is useful for showing a readme file, unpacking some archives,
; or just starting up the program that was just installed. In
; the example below, note that the filename starts with a backslash.
; This indicates that the program is in the PATH. Otherwise,
; it is assumed to be located relative to the installation
; directory. You can also use macros to indicate directories.
; The MESSAGE label denotes the text that will be
; displayed in the message box that prompts the user just before
; the EXEFILE is run. If there is no MESSAGE, then the EXEFILE
; is run without prompting the user.
; -------------------------------------------------------------
[infofile]
filename, README.NOW
appname, "SAMPLE APPL"
; exefile, "\notepad.exe sub\readme.now"
exefile, "#W\notepad.exe #X\readme.now"
message, "Do you want to view the readme file?"
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; DIALOG
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; The [dialog caption] section is used to define the caption
; of the windows that are shown in the INSTALL program.
; -------------------------------------------------------------
[dialog]
iconname, "TEST.ICO" ; specify your own icon here
caption, "Sample Installation"
info, YES ;Determines whether the introductory dialog
;will be displayed. NO hides it
DirSelect, YES ;Determines whether the dir prompt dialog
;will be displayed. NO hides it
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; DATA
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; The [data defdir] section defines the default directory. This
; directory is placed in the Install location editbox when the
; program starts. If the user does not change it, then this
; will be the base directory of the installation. To reference
; the WINDOWS directory on the user's system, use the #W macro.
; -------------------------------------------------------------
[data]
defdir, #W\SYSTEM\INSTWARE
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; DISKS
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
;
; The [disks] section defines the distribution disks that contain the
; application files. InstallWare uses this information to tell the user to
; insert the correct disk.
;
; Elsewhere within this .INF file, the distribution disks are normally
; referred to by a single-character disk ID. This section defines those
; disk IDs, and includes information about the disk to which each disk ID
; refers.
;
; The disk ID '0' is reserved; it represents the installation directory --
; the directory in which the user is installing the application.
;
; The format of each disk definition is:
;
; n = path, title
;
; where
; n is the disk ID (a single character from 1-9 or A-Z).
;
; path the path of the source directory from which InstallWare should
; copy the files to the disk. The path can be relative to the
; source directory (see examples below).
;
; title is a descriptive name for the disk. The title should match
; the disk's printed or written label exactly.
;
; The following statements would define two distribution disks.
;
; 1 =., "Demo Application Disk 1"
; 2 =.\files, "Demo Application Disk 2"
;
; The first statement tells InstallWare to refer to Disk 1 as "Demo Application
; Disk 1". Because the period (.) denotes the current directory, the files
; on that disk will be copied from the root directory of the
; distribution disk.
;
; The second statement tells InstallWare to refer to Disk 2 as "Demo
; Application Disk 2"; the files that Disk 2 contains will be copied
; from the \FILES directory of the distribution disk.
;
; You can include as many disk-definition statements as necessary. Every
; distribution disk should have a corresponding disk-definition statement;
; otherwise, InstallWare cannot tell the user to insert the appropriate disk.
;
; For the purposes of this file we will use this disk definition line:
[disks]
1 =., "INSTALL"
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; NEEDED.SPACE
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; This section tells INSTALL how much space is needed on the
; target disk to do a successful installation. The user will
; get an error message if they try to install to a disk that
; has less space.
; -------------------------------------------------------------
[needed.space]
minspace = 12000
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; DEST.DIRECTORIES
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; The [dest.directories] section contains section-definition statements.
; Each statement defines a section that lists application files to be
; copied as part of installation. The sections are organized by file
; destination; you should define a separate section for each destination
; directory.
;
; Each section definition has the following form:
;
; #section_name, 0:dest_pathname
;
; where
;
; #section_name defines the name of the .INF section that lists the
; files to be copied.
; 0 is the disk ID that represents the installation directory.
; (0 is a reserved disk ID, and always represents the
; installation directory -- the directory the user specified
; when asked where to install the application.)
; dest_pathname is the pathname of the destination directory, relative
; to the installation directory. For example, "0:FILES"
; represents the FILES subdirectory of the installation
; directory.
;
; -------------------------------------------------------------
; In the example below, the first two entries define application
; specific directories. The #app.main directory will be the
; base directory defined by the user (or the default as
; described above). The #app.sub directory will cause a
; directory called sub to be created off of the base directory.
;
; The third and fourth entries refer to the two Windows
; specific directories: \WINDOWS and \WINDOWS\SYSTEM.
; INSTALL will find these directories and copy the specified
; files into them.
; -------------------------------------------------------------
[dest.directories]
#app.main, 0:
#app.sub, 0:sub
#app.empty, 0:empty
#app.SETUPSYSDIR, 0:SETUPSYSDIR
#app.SETUPWINDIR, 0:SETUPWINDIR
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; USER-DEFINED SECTION
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; This section is a user-defined section that lists files to be copied to a
; particular destination directory. The [dest.directories] section defines.
; the name of this section and the destination directory of the files.
;
; In each section like this one, you should list all files that you want copied
; to the same destination. (For example, all the files in this section,
; [app.user], will be copied to the installation directory.)
;
; InstallWare copies the files listed in this section in the order in which they
; are listed.
;
; The syntax of each file listing is
;
; N:FILENAME, "Description"
;
; where
;
; N: is the disk ID of the disk that contains the file. (Disk
; IDs are defined in the [disks] section.) If the specified
; disk is not in the disk drive, InstallWare prompts the
; user to insert it.
;
; FILENAME is the name of the file, including any filename extension.
;
; Description is descriptive text that InstallWare displays as it is
; copying the file or group of files. If you leave the
; description blank, InstallWare will continue displaying
; the descriptive text from the previous file. This lets
; you use a general name for a group of files.
;
;
; -------------------------------------------------------------
; This is the file list for the base directory.
; -------------------------------------------------------------
[app.main]
1:ARCADE.BMP@050004 ; Show this bitmap at location 50, 4
1:APPSETUP.INF, "Application Configuration File"
1:INSTWAR.HLP, "Application Help File"
1:INSTALL.ICO, "Application Icon"
; 1:FRAG.EXE, "Fragger"
; 1:TEST.001, "Test File"
; 1:TEST.002, "Test File"
; 1:TEST.003, "Test File"
; -------------------------------------------------------------
; This is the file list for the \WINDOWS\SYSTEM directory.
; -------------------------------------------------------------
[app.SETUPSYSDIR]
1:README.NOW, "##WReadme File" ; This shows the literal ## non-macro
; -------------------------------------------------------------
; This is the file list for the \WINDOWS\SYSTEM directory.
; -------------------------------------------------------------
[app.SETUPWINDIR]
; -------------------------------------------------------------
; This is the file list for the sub directory located off of
; the base directory.
; -------------------------------------------------------------
[app.sub]
1:CASTLE.BMP@090090 ; Show this bitmap at location 90, 90
1:README.NOW, "README"
1:INSTALL.EXE, "INSTALL.EXE"
1:IW.EXE, "IW.EXE"
1:SFX.EXE, "Test Executable"
; 1:COMPR.C, "Test Compressed"
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; PROGMAN.GROUPS
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; The [progman.groups] section (optional) tells InstallWare to create Program
; Manager groups for your application. (InstallWare then uses DDE to
; communicate with Program Manager.)
;
; The section lists the names of the groups you want to create. You then
; define additional sections in this file; those sections list the program
; items you want in each group.
;
; The syntax for each group name is:
;
; groupname, [groupfile.grp]
;
; where
;
; groupname is the title you want Program Manager to display
; under the icon that represents the group. (The
; groupname will also be the name of the section
; that defines the contents of the group.)
;
; groupfile.grp is the filename of the file in which Program Manager
; will save information about the group. (You must include
; the .GRP filename extension.) This parameter is optional;
; if you omit it, InstallWare uses a default name for the
; group file.
;
; The following group-definition statement tells InstallWare to create a
; group named "Bob Dolan Shareware", and store its information in a file
; named BOBDOLAN.GRP.
[progman.groups]
"Bob Dolan Shareware", MYGROUP.GRP
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; USER-DEFINED PROGMAN.GROUPS
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; This section describes the Program Item Icon to add to the
; Program Group defined in the section heading.
;
; In each section like this one, you should list all items that you want
; InstallWare to add to the group.
;
; The syntax for item-definition statements is:
;
; "Description", APPFILE.EXE, [ICONFILE.EXE[, N]]
;
;where
;
; Description is the text that will appear below the program icon
; when displayed in the Program Manager group.
;
; APPFILE.EXE is the command line that starts the application.
;
; ICONFILE.EXE is the application file that contains the icon you
; want to represent the application. Typically, this is
; the executable application file, but it could be a
; different file. (You can also specify a .ICO file, created
; using an icon editor.) This parameter is optional; if
; you omit it, InstallWare will use the first icon it finds in
; APPFILE.EXE.
;
; N is the offset of the icon you want to use within the file
; ICONFILE.EXE. This parameter is optional; if you omit it,
; InstallWare uses the first icon it finds in ICONFILE.EXE.
; You must include this parameter if the file you specify
; contains more than one icon, and you want to use an icon
; other than the first icon.
;
; To use the Nth icon, specify the number N-1. For example,
; to use the third icon, specify 2.
;
; For example, the following item-definition statement tells InstallWare to add
; an item titled "Install" to Program Manager. The application command line is
; a file named INSTALL.EXE which is located in the SUB subdirectory off of the
; installation directory.
["Bob Dolan Shareware"]
; "Install", #D\SUB\IW.EXE
"Install", #D\SUB\IW.EXE, , ,C:\DOS ; This example shows use of a working directory
"Install & Help", "winhelp #D\INSTWAR.HLP", #D\INSTALL.ICO
"Test Paths", "#W\NOTEPAD.EXE #D\SUB\R2.TXT"
; -------------------------------------------------------------
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; INI FILE MODIFICATION
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; This section defines any INI file modifications that will be performed.
; The Installation Directory can be referenced by using the #D macro as is
; shown in the examples below. If you specify an INI file that does not exist,
; it will be created. If you do not specify a path, the WINDOWS directory is
; used. Be sure to use quotes around text that contains spaces (see example).
; The format is as follows:
; INIFILENAME, INI SectionName, Entry Label, Actual Text to be added
[INIFiles]
WIN.INI, InstallWare, TestEntry1, TestString1
WIN.INI, InstallWare, TestEntry2, #D
SYSTEM.INI, InstallWare, TestEntry1, TestString1
CONTROL.INI, InstallWare, TestEntry2, #D\SUBDIR\FILENAME.EXT
BOB.INI, InstallWare, TestEntry1, "Bob wrote this!"
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; NON-OPTIONAL EXECUTABLE FILE LIST
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; This section lists the files that will be executed to complete the installation.
; The user is not prompted as to whether they would like these files to be run.
; Common uses are running self-extracting archives or tutorials. The filename
; that is specified is assumed to be relative to the install path. The DELETE
; FLAG parameter indicates whether the file is deleted after it has completed
; executing. All files run in succession, and processing of InstallWare is
; suspended until each file terminates. Use the #D or #W macros to reference
; the directory that was used for the installation. A directory change is made
; just before the Command is run. The directory changed to will be the same as
; the executable. If no directory is specified, the installation directory is
; used. In the following example using NOTEPAD, the application is in the PATH
; and the directory is the installation directory so the command line parameter
; is relative to the installation directory.
; The format is as follows:
; EXECUTABLE FILENAME, DELETE FLAG (YES/NO)
[ExtCmds]
; #D\SUB\SFX.EXE, YES, NOTONTOP
"NOTEPAD.EXE #D\sub\readme.now", NO, ONTOP
; "#D\FRAG.EXE d #D\TEST #D\sub 0", YES ; Test Fragger
; "NOTEPAD.EXE #V\BOOTLOG.TXT", NO
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; OPTIONS
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; This section allows for the customization of several InstallWare functions.
; The format is as follows:
; OPTION, FLAG (YES/NO)
[Options]
Compressed, NO ; If set to YES, then the LZ copy routines will be used
; and will automatically decompress any files that are
; compressed using the Microsoft COMPRESS utility.
; However, only a job progress bar will be shown since
; the LZ routines do not update the application during
; file copies. If this option is set to NO, then DOS
; read and write routines will be used and no file
; decompression will occur. However, two progress bars
; will be used: one to show the job progress and the
; other will show file progress. This is most useful
; for installations that will be moving very large
; files, in that it lets the user know that the setup
; is still alive.
Logging, YES ; If this option is set to YES, then a log file will
; be created, detailing the installation.
DirChg, yes ; If this option is set to NO, the Install directory
; editbox will not be displayed
OverWrite, NO ; This option determines what the default setting of
; of the OverWrite radio buttons will be.
;-----ReBoot/ReStart Section------
; Make sure you enable ONLY one of
; these options. If bother are enabled,
; a ReBoot will occur automatically.
Restart, YES ; If this option is set to YES, the user will be
; prompted to restart Windows. If set to NO, it will
; just happen (the developer should warn about this
; at the beginning of the install). If the field is not
; present, then no restart will occur.
; Reboot, YES ; If this option is set to YES, the user will be
; prompted to reboot the system. If set to NO, it will
; just happen (the developer should warn about this
; at the beginning of the install). If the field is not
; present, then no reboot will occur.
RestartString, "The system must be rebooted/restarted for all changes to take effect. Would you like to do this now?"
; This field MUST be present if you use either of the
; reboot/restart fields.
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; WINDOW
; -------------------------------------------------------------
; *************************************************************
; -------------------------------------------------------------
; This section allows for describing the InstallWare backdrop window.
; The format is different for each field.
[Window]
Focus, NO ;If set to YES, the window stays on top,
;keeping the user focused on the installation.
Show, YES ;If set to YES, the backdrop window is shown
;Otherwise, it is not and all other vars are ignored.
Style, FULL ;If set to FULL, no caption is displayed.
Color, RED ;Options are gradients of RED, GREEN, and
;BLUE (which is the default)
Message, "InstallWare 4.2!" ;This message is shown in the window
Caption, "This is the InstallWare Demo" ;This message is shown in
;the caption of the window
;if it not set to FULL
MessageLoc, BOTTOM ;Location of the Message string: TOP or BOTTOM
InitialBMP, "features.BMP" ; Specifies the name of the bitmap to show at startup
InitialBMPX, 10 ; Specifies the location to show the initial bitmap at
InitialBMPY, 10 ; In this case we are showing at 10, 10